Autogenerated HTML docs for v1.5.3-rc4-67-gf9286
diff --git a/blame-options.txt b/blame-options.txt index a46bf6c..17379f0 100644 --- a/blame-options.txt +++ b/blame-options.txt
@@ -64,11 +64,11 @@ assigns blame to the lines that were moved down (i.e. A) to the child commit. With this option, both groups of lines are blamed on the parent. - - <num> is optional but it is the lower bound on the number of - alphanumeric characters that git must detect as moving - within a file for it to associate those lines with the parent - commit. ++ +<num> is optional but it is the lower bound on the number of +alphanumeric characters that git must detect as moving +within a file for it to associate those lines with the parent +commit. -C|<num>|:: In addition to `-M`, detect lines copied from other @@ -77,11 +77,11 @@ around across files. When this option is given twice, the command looks for copies from all other files in the parent for the commit that creates the file in addition. - - <num> is optional but it is the lower bound on the number of - alphanumeric characters that git must detect as moving - between files for it to associate those lines with the parent - commit. ++ +<num> is optional but it is the lower bound on the number of +alphanumeric characters that git must detect as moving +between files for it to associate those lines with the parent +commit. -h, --help:: Show help message.
diff --git a/cmds-ancillaryinterrogators.txt b/cmds-ancillaryinterrogators.txt index 5a52eab..c8b7db2 100644 --- a/cmds-ancillaryinterrogators.txt +++ b/cmds-ancillaryinterrogators.txt
@@ -35,7 +35,7 @@ Show branches and their commits. gitlink:git-verify-tag[1]:: - Check the GPG signature of tag. + Check the GPG signature of tags. gitlink:git-whatchanged[1]:: Show logs with difference each commit introduces.
diff --git a/cmds-ancillarymanipulators.txt b/cmds-ancillarymanipulators.txt index f336665..b41bdc3 100644 --- a/cmds-ancillarymanipulators.txt +++ b/cmds-ancillarymanipulators.txt
@@ -1,3 +1,6 @@ +gitlink:git-config[1]:: + Get and set repository or global options. + gitlink:git-convert-objects[1]:: Converts old-style git repository. @@ -25,12 +28,9 @@ gitlink:git-relink[1]:: Hardlink common objects in local repositories. -gitlink:git-repack[1]:: - Pack unpacked objects in a repository. - -gitlink:git-config[1]:: - Get and set repository or global options. - gitlink:git-remote[1]:: manage set of tracked repositories. +gitlink:git-repack[1]:: + Pack unpacked objects in a repository. +
diff --git a/git-annotate.html b/git-annotate.html index f6a5d98..87f4beb 100644 --- a/git-annotate.html +++ b/git-annotate.html
@@ -408,13 +408,10 @@ to the child commit. With this option, both groups of lines are blamed on the parent. </p> -<div class="literalblock"> -<div class="content"> -<pre><tt><num> is optional but it is the lower bound on the number of +<p><num> is optional but it is the lower bound on the number of alphanumeric characters that git must detect as moving within a file for it to associate those lines with the parent -commit.</tt></pre> -</div></div> +commit.</p> </dd> <dt> -C|<num>| @@ -428,13 +425,10 @@ the command looks for copies from all other files in the parent for the commit that creates the file in addition. </p> -<div class="literalblock"> -<div class="content"> -<pre><tt><num> is optional but it is the lower bound on the number of +<p><num> is optional but it is the lower bound on the number of alphanumeric characters that git must detect as moving between files for it to associate those lines with the parent -commit.</tt></pre> -</div></div> +commit.</p> </dd> <dt> -h, --help @@ -460,7 +454,7 @@ </div> <div id="footer"> <div id="footer-text"> -Last updated 19-Jul-2007 02:09:31 UTC +Last updated 10-Aug-2007 09:49:28 UTC </div> </div> </body>
diff --git a/git-blame.html b/git-blame.html index f195b81..fbe4089 100644 --- a/git-blame.html +++ b/git-blame.html
@@ -426,13 +426,10 @@ to the child commit. With this option, both groups of lines are blamed on the parent. </p> -<div class="literalblock"> -<div class="content"> -<pre><tt><num> is optional but it is the lower bound on the number of +<p><num> is optional but it is the lower bound on the number of alphanumeric characters that git must detect as moving within a file for it to associate those lines with the parent -commit.</tt></pre> -</div></div> +commit.</p> </dd> <dt> -C|<num>| @@ -446,13 +443,10 @@ the command looks for copies from all other files in the parent for the commit that creates the file in addition. </p> -<div class="literalblock"> -<div class="content"> -<pre><tt><num> is optional but it is the lower bound on the number of +<p><num> is optional but it is the lower bound on the number of alphanumeric characters that git must detect as moving between files for it to associate those lines with the parent -commit.</tt></pre> -</div></div> +commit.</p> </dd> <dt> -h, --help @@ -692,7 +686,7 @@ </div> <div id="footer"> <div id="footer-text"> -Last updated 19-Jul-2007 02:09:32 UTC +Last updated 10-Aug-2007 09:49:28 UTC </div> </div> </body>
diff --git a/git-clone.html b/git-clone.html index a35e341..c2e1c8a 100644 --- a/git-clone.html +++ b/git-clone.html
@@ -273,7 +273,8 @@ <h2>SYNOPSIS</h2> <div class="sectionbody"> <div class="verseblock"> -<div class="content"><em>git-clone</em> [--template=<template_directory>] [-l [-s]] [-q] [-n] [--bare] +<div class="content"><em>git-clone</em> [--template=<template_directory>] + [-l] [-s] [--no-hardlinks] [-q] [-n] [--bare] [-o <name>] [-u <upload-pack>] [--reference <repository>] [--depth <depth>] <repository> [<directory>]</div></div> </div> @@ -307,8 +308,24 @@ this flag bypasses normal "git aware" transport mechanism and clones the repository by making a copy of HEAD and everything under objects and refs directories. - The files under .git/objects/ directory are hardlinked - to save space when possible. + The files under <tt>.git/objects/</tt> directory are hardlinked + to save space when possible. This is now the default when + the source repository is specified with <tt>/path/to/repo</tt> + syntax, so it essentially is a no-op option. To force + copying instead of hardlinking (which may be desirable + if you are trying to make a back-up of your repository), + but still avoid the usual "git aware" transport + mechanism, <tt>--no-hardlinks</tt> can be used. +</p> +</dd> +<dt> +--no-hardlinks +</dt> +<dd> +<p> + Optimize the cloning process from a repository on a + local filesystem by copying files under <tt>.git/objects</tt> + directory. </p> </dd> <dt> @@ -502,11 +519,11 @@ </li> </ul> </div></div> -<p>SSH is the default transport protocol. You can optionally specify -which user to log-in as, and an alternate, scp-like syntax is also -supported. Both syntaxes support username expansion, -as does the native git protocol. The following three are -identical to the last three above, respectively:</p> +<p>SSH is the default transport protocol over the network. You can +optionally specify which user to log-in as, and an alternate, +scp-like syntax is also supported. Both syntaxes support +username expansion, as does the native git protocol. The following +three are identical to the last three above, respectively:</p> <div class="exampleblock"> <div class="exampleblock-content"> <ul> @@ -527,7 +544,7 @@ </li> </ul> </div></div> -<p>To sync with a local directory, use:</p> +<p>To sync with a local directory, you can use:</p> <div class="exampleblock"> <div class="exampleblock-content"> <ul> @@ -536,8 +553,15 @@ /path/to/repo.git/ </p> </li> +<li> +<p> +file:///path/to/repo.git/ +</p> +</li> </ul> </div></div> +<p>They are mostly equivalent, except when cloning. See +<a href="git-clone.html">git-clone(1)</a> for details.</p> </div> <h2>Examples</h2> <div class="sectionbody"> @@ -611,7 +635,7 @@ </div> <div id="footer"> <div id="footer-text"> -Last updated 19-Jul-2007 02:09:34 UTC +Last updated 11-Aug-2007 08:29:13 UTC </div> </div> </body>
diff --git a/git-clone.txt b/git-clone.txt index a0a10e3..227f092 100644 --- a/git-clone.txt +++ b/git-clone.txt
@@ -9,7 +9,8 @@ SYNOPSIS -------- [verse] -'git-clone' [--template=<template_directory>] [-l [-s]] [-q] [-n] [--bare] +'git-clone' [--template=<template_directory>] + [-l] [-s] [--no-hardlinks] [-q] [-n] [--bare] [-o <name>] [-u <upload-pack>] [--reference <repository>] [--depth <depth>] <repository> [<directory>] @@ -40,8 +41,19 @@ this flag bypasses normal "git aware" transport mechanism and clones the repository by making a copy of HEAD and everything under objects and refs directories. - The files under .git/objects/ directory are hardlinked - to save space when possible. + The files under `.git/objects/` directory are hardlinked + to save space when possible. This is now the default when + the source repository is specified with `/path/to/repo` + syntax, so it essentially is a no-op option. To force + copying instead of hardlinking (which may be desirable + if you are trying to make a back-up of your repository), + but still avoid the usual "git aware" transport + mechanism, `--no-hardlinks` can be used. + +--no-hardlinks:: + Optimize the cloning process from a repository on a + local filesystem by copying files under `.git/objects` + directory. --shared:: -s::
diff --git a/git-fetch.html b/git-fetch.html index df9dcc1..e19a1c7 100644 --- a/git-fetch.html +++ b/git-fetch.html
@@ -546,11 +546,11 @@ </li> </ul> </div></div> -<p>SSH is the default transport protocol. You can optionally specify -which user to log-in as, and an alternate, scp-like syntax is also -supported. Both syntaxes support username expansion, -as does the native git protocol. The following three are -identical to the last three above, respectively:</p> +<p>SSH is the default transport protocol over the network. You can +optionally specify which user to log-in as, and an alternate, +scp-like syntax is also supported. Both syntaxes support +username expansion, as does the native git protocol. The following +three are identical to the last three above, respectively:</p> <div class="exampleblock"> <div class="exampleblock-content"> <ul> @@ -571,7 +571,7 @@ </li> </ul> </div></div> -<p>To sync with a local directory, use:</p> +<p>To sync with a local directory, you can use:</p> <div class="exampleblock"> <div class="exampleblock-content"> <ul> @@ -580,8 +580,15 @@ /path/to/repo.git/ </p> </li> +<li> +<p> +file:///path/to/repo.git/ +</p> +</li> </ul> </div></div> +<p>They are mostly equivalent, except when cloning. See +<a href="git-clone.html">git-clone(1)</a> for details.</p> </div> <h2>REMOTES</h2> <div class="sectionbody"> @@ -651,7 +658,7 @@ </div> <div id="footer"> <div id="footer-text"> -Last updated 19-Jul-2007 02:09:40 UTC +Last updated 11-Aug-2007 08:29:13 UTC </div> </div> </body>
diff --git a/git-pull.html b/git-pull.html index 761e911..02c4949 100644 --- a/git-pull.html +++ b/git-pull.html
@@ -592,11 +592,11 @@ </li> </ul> </div></div> -<p>SSH is the default transport protocol. You can optionally specify -which user to log-in as, and an alternate, scp-like syntax is also -supported. Both syntaxes support username expansion, -as does the native git protocol. The following three are -identical to the last three above, respectively:</p> +<p>SSH is the default transport protocol over the network. You can +optionally specify which user to log-in as, and an alternate, +scp-like syntax is also supported. Both syntaxes support +username expansion, as does the native git protocol. The following +three are identical to the last three above, respectively:</p> <div class="exampleblock"> <div class="exampleblock-content"> <ul> @@ -617,7 +617,7 @@ </li> </ul> </div></div> -<p>To sync with a local directory, use:</p> +<p>To sync with a local directory, you can use:</p> <div class="exampleblock"> <div class="exampleblock-content"> <ul> @@ -626,8 +626,15 @@ /path/to/repo.git/ </p> </li> +<li> +<p> +file:///path/to/repo.git/ +</p> +</li> </ul> </div></div> +<p>They are mostly equivalent, except when cloning. See +<a href="git-clone.html">git-clone(1)</a> for details.</p> </div> <h2>REMOTES</h2> <div class="sectionbody"> @@ -896,7 +903,7 @@ </div> <div id="footer"> <div id="footer-text"> -Last updated 19-Jul-2007 02:09:49 UTC +Last updated 11-Aug-2007 08:29:14 UTC </div> </div> </body>
diff --git a/git-push.html b/git-push.html index ca357b6..8bd7ede 100644 --- a/git-push.html +++ b/git-push.html
@@ -452,11 +452,11 @@ </li> </ul> </div></div> -<p>SSH is the default transport protocol. You can optionally specify -which user to log-in as, and an alternate, scp-like syntax is also -supported. Both syntaxes support username expansion, -as does the native git protocol. The following three are -identical to the last three above, respectively:</p> +<p>SSH is the default transport protocol over the network. You can +optionally specify which user to log-in as, and an alternate, +scp-like syntax is also supported. Both syntaxes support +username expansion, as does the native git protocol. The following +three are identical to the last three above, respectively:</p> <div class="exampleblock"> <div class="exampleblock-content"> <ul> @@ -477,7 +477,7 @@ </li> </ul> </div></div> -<p>To sync with a local directory, use:</p> +<p>To sync with a local directory, you can use:</p> <div class="exampleblock"> <div class="exampleblock-content"> <ul> @@ -486,8 +486,15 @@ /path/to/repo.git/ </p> </li> +<li> +<p> +file:///path/to/repo.git/ +</p> +</li> </ul> </div></div> +<p>They are mostly equivalent, except when cloning. See +<a href="git-clone.html">git-clone(1)</a> for details.</p> </div> <h2>REMOTES</h2> <div class="sectionbody"> @@ -589,7 +596,7 @@ </div> <div id="footer"> <div id="footer-text"> -Last updated 06-Aug-2007 04:38:48 UTC +Last updated 11-Aug-2007 08:29:14 UTC </div> </div> </body>
diff --git a/git-rev-parse.html b/git-rev-parse.html index 35d8995..6f45c66 100644 --- a/git-rev-parse.html +++ b/git-rev-parse.html
@@ -735,7 +735,7 @@ </div> <div id="footer"> <div id="footer-text"> -Last updated 19-Jul-2007 02:09:52 UTC +Last updated 10-Aug-2007 09:49:28 UTC </div> </div> </body>
diff --git a/git-rev-parse.txt b/git-rev-parse.txt index eea9c9c..4b4d229 100644 --- a/git-rev-parse.txt +++ b/git-rev-parse.txt
@@ -224,7 +224,7 @@ G H I J \ / \ / D E F - \ | / \ + \ | / \ \ | / | \|/ | B C
diff --git a/git-stripspace.html b/git-stripspace.html index 7dc91d4..04bb82d 100644 --- a/git-stripspace.html +++ b/git-stripspace.html
@@ -272,7 +272,7 @@ </div> <h2>SYNOPSIS</h2> <div class="sectionbody"> -<p><em>git-stripspace</em> < <stream></p> +<p><em>git-stripspace</em> [-s | --strip-comments] < <stream></p> </div> <h2>DESCRIPTION</h2> <div class="sectionbody"> @@ -282,6 +282,14 @@ <div class="sectionbody"> <dl> <dt> +-s\|--strip-comments +</dt> +<dd> +<p> + In addition to empty lines, also strip lines starting with <em>#</em>. +</p> +</dd> +<dt> <stream> </dt> <dd> @@ -305,7 +313,7 @@ </div> <div id="footer"> <div id="footer-text"> -Last updated 19-Jul-2007 02:09:56 UTC +Last updated 11-Aug-2007 08:29:16 UTC </div> </div> </body>
diff --git a/git-stripspace.txt b/git-stripspace.txt index 1306d7b..5212358 100644 --- a/git-stripspace.txt +++ b/git-stripspace.txt
@@ -8,7 +8,7 @@ SYNOPSIS -------- -'git-stripspace' < <stream> +'git-stripspace' [-s | --strip-comments] < <stream> DESCRIPTION ----------- @@ -16,6 +16,9 @@ OPTIONS ------- +-s\|--strip-comments:: + In addition to empty lines, also strip lines starting with '#'. + <stream>:: Byte stream to act on.
diff --git a/git-tag.html b/git-tag.html index 5fd9eec..4a468db 100644 --- a/git-tag.html +++ b/git-tag.html
@@ -276,7 +276,7 @@ <div class="content"><em>git-tag</em> [-a | -s | -u <key-id>] [-f] [-m <msg> | -F <file>] <name> [<head>] <em>git-tag</em> -d <name>… <em>git-tag</em> [-n [<num>]] -l [<pattern>] -<em>git-tag</em> -v <name></div></div> +<em>git-tag</em> -v <name>…</div></div> </div> <h2>DESCRIPTION</h2> <div class="sectionbody"> @@ -285,7 +285,7 @@ <tt>.git/refs/tags/</tt> directory.</p> <p>If one of <tt>-a</tt>, <tt>-s</tt>, or <tt>-u <key-id></tt> is passed, the command creates a <em>tag</em> object, and requires the tag message. Unless -<tt>-m <msg></tt> is given, an editor is started for the user to type +<tt>-m <msg></tt> or <tt>-F <file></tt> is given, an editor is started for the user to type in the tag message.</p> <p>Otherwise just the SHA1 object name of the commit object is written (i.e. a lightweight tag).</p> @@ -346,7 +346,7 @@ </dt> <dd> <p> - Verify the gpg signature of given the tag + Verify the gpg signature of the given tag names. </p> </dd> <dt> @@ -357,6 +357,7 @@ <num> specifies how many lines from the annotation, if any, are printed when using -l. The default is not to print any annotation lines. + If no number is given to <tt>-n</tt>, only the first line is printed. </p> </dd> <dt> @@ -365,6 +366,7 @@ <dd> <p> List tags with names that match the given pattern (or all if no pattern is given). + Typing "git tag" without arguments, also lists all tags. </p> </dd> <dt> @@ -531,7 +533,7 @@ </div> <div id="footer"> <div id="footer-text"> -Last updated 19-Jul-2007 02:09:57 UTC +Last updated 11-Aug-2007 08:29:16 UTC </div> </div> </body>
diff --git a/git-tag.txt b/git-tag.txt index aee2c1b..119117f 100644 --- a/git-tag.txt +++ b/git-tag.txt
@@ -12,7 +12,7 @@ 'git-tag' [-a | -s | -u <key-id>] [-f] [-m <msg> | -F <file>] <name> [<head>] 'git-tag' -d <name>... 'git-tag' [-n [<num>]] -l [<pattern>] -'git-tag' -v <name> +'git-tag' -v <name>... DESCRIPTION ----------- @@ -23,7 +23,7 @@ If one of `-a`, `-s`, or `-u <key-id>` is passed, the command creates a 'tag' object, and requires the tag message. Unless -`-m <msg>` is given, an editor is started for the user to type +`-m <msg>` or `-F <file>` is given, an editor is started for the user to type in the tag message. Otherwise just the SHA1 object name of the commit object is @@ -59,15 +59,17 @@ Delete existing tags with the given names. -v:: - Verify the gpg signature of given the tag + Verify the gpg signature of the given tag names. -n <num>:: <num> specifies how many lines from the annotation, if any, are printed when using -l. The default is not to print any annotation lines. + If no number is given to `-n`, only the first line is printed. -l <pattern>:: List tags with names that match the given pattern (or all if no pattern is given). + Typing "git tag" without arguments, also lists all tags. -m <msg>:: Use the given tag message (instead of prompting)
diff --git a/git-verify-tag.html b/git-verify-tag.html index 7215010..7a1b9ca 100644 --- a/git-verify-tag.html +++ b/git-verify-tag.html
@@ -266,13 +266,13 @@ <h2>NAME</h2> <div class="sectionbody"> <p>git-verify-tag - - Check the GPG signature of tag + Check the GPG signature of tags </p> </div> </div> <h2>SYNOPSIS</h2> <div class="sectionbody"> -<p><em>git-verify-tag</em> <tag></p> +<p><em>git-verify-tag</em> <tag>…</p> </div> <h2>DESCRIPTION</h2> <div class="sectionbody"> @@ -305,7 +305,7 @@ </div> <div id="footer"> <div id="footer-text"> -Last updated 19-Jul-2007 02:09:59 UTC +Last updated 11-Aug-2007 08:29:16 UTC </div> </div> </body>
diff --git a/git-verify-tag.txt b/git-verify-tag.txt index 48d17fd..ac7fb19 100644 --- a/git-verify-tag.txt +++ b/git-verify-tag.txt
@@ -3,11 +3,11 @@ NAME ---- -git-verify-tag - Check the GPG signature of tag +git-verify-tag - Check the GPG signature of tags SYNOPSIS -------- -'git-verify-tag' <tag> +'git-verify-tag' <tag>... DESCRIPTION -----------
diff --git a/git.html b/git.html index 4c77180..169487a 100644 --- a/git.html +++ b/git.html
@@ -681,6 +681,14 @@ <p>Manipulators:</p> <dl> <dt> +<a href="git-config.html">git-config(1)</a> +</dt> +<dd> +<p> + Get and set repository or global options. +</p> +</dd> +<dt> <a href="git-convert-objects.html">git-convert-objects(1)</a> </dt> <dd> @@ -753,22 +761,6 @@ </p> </dd> <dt> -<a href="git-repack.html">git-repack(1)</a> -</dt> -<dd> -<p> - Pack unpacked objects in a repository. -</p> -</dd> -<dt> -<a href="git-config.html">git-config(1)</a> -</dt> -<dd> -<p> - Get and set repository or global options. -</p> -</dd> -<dt> <a href="git-remote.html">git-remote(1)</a> </dt> <dd> @@ -776,6 +768,14 @@ manage set of tracked repositories. </p> </dd> +<dt> +<a href="git-repack.html">git-repack(1)</a> +</dt> +<dd> +<p> + Pack unpacked objects in a repository. +</p> +</dd> </dl> <p>Interrogators:</p> <dl> @@ -880,7 +880,7 @@ </dt> <dd> <p> - Check the GPG signature of tag. + Check the GPG signature of tags. </p> </dd> <dt> @@ -2429,7 +2429,7 @@ </div> <div id="footer"> <div id="footer-text"> -Last updated 06-Aug-2007 04:38:49 UTC +Last updated 11-Aug-2007 08:29:16 UTC </div> </div> </body>
diff --git a/urls.txt b/urls.txt index 781df41..b38145f 100644 --- a/urls.txt +++ b/urls.txt
@@ -15,11 +15,11 @@ - ssh://{startsb}user@{endsb}host.xz/~/path/to/repo.git =============================================================== -SSH is the default transport protocol. You can optionally specify -which user to log-in as, and an alternate, scp-like syntax is also -supported. Both syntaxes support username expansion, -as does the native git protocol. The following three are -identical to the last three above, respectively: +SSH is the default transport protocol over the network. You can +optionally specify which user to log-in as, and an alternate, +scp-like syntax is also supported. Both syntaxes support +username expansion, as does the native git protocol. The following +three are identical to the last three above, respectively: =============================================================== - {startsb}user@{endsb}host.xz:/path/to/repo.git/ @@ -27,8 +27,12 @@ - {startsb}user@{endsb}host.xz:path/to/repo.git =============================================================== -To sync with a local directory, use: +To sync with a local directory, you can use: =============================================================== - /path/to/repo.git/ +- file:///path/to/repo.git/ =============================================================== + +They are mostly equivalent, except when cloning. See +gitlink:git-clone[1] for details. 